Implement scantxoutset method and test by GideonBature · Pull Request #164 · rust-bitcoin/corepc

GideonBature · 2025-05-12T23:20:53Z

The JSON-RPC method scantxoutset does return a type. We want to test this to catch any changes in behavior in future Core versions.

This PR adds a client function that errors if the return value is anything other than the type it returns, along with an integration test that calls this function.

Ref: #116
Closes #115

tcharding · 2025-05-13T04:23:56Z

Why is there identical code in the v17 and v18 blockchain modules of the client?

GideonBature · 2025-05-13T04:50:25Z

Why is there identical code in the v17 and v18 blockchain modules of the client?

They basically work the same way, the difference is in their return type, v18 has an additional field (desc) in it's result, whereas it is lacking in v17. Or is there a way to reuse the client code in v17 for v18 and still be able to return the type that is meant for v18?

tcharding · 2025-05-13T22:44:21Z

Bro I explained this to you already on the other two PRs you did. Perhaps go back over them and see if you can work it out.

GideonBature · 2025-05-14T17:09:45Z

Bro I explained this to you already on the other two PRs you did. Perhaps go back over them and see if you can work it out.

oh, I now understand, I was looking at how gettxout was used in the client, where despite the code is similar, they used it for v17 and again for v22. So I thought that for any change in the fields of return type of a method, there should also be a code in the module of the client for that particular version with the change. But I can see that it's not always the case.

For this recent push, I removed the repeated code across all versions having different fields in their type.

tcharding · 2025-05-15T00:04:59Z

Oh well that would explain your confusion, the gettxout in v22 is just plain wrong. I'll remove it.

tcharding · 2025-05-15T00:09:24Z

Done in #169. FTR bugs happen, if you see things that are wrong or look weird just ask (or PR to fix them). Apologies for being so fierce yesterday.

tcharding · 2025-05-15T02:19:12Z

Returns column needs updating (and Notes).

tcharding

Holy moly you picked a difficult one. I'm going to have to come back to this when I can put more thought into it. Feel free to ignore my suggestions until then.

integration_test/tests/blockchain.rs

types/src/v17/blockchain/mod.rs

GideonBature · 2025-05-15T14:01:16Z

Done in #169. FTR bugs happen, if you see things that are wrong or look weird just ask (or PR to fix them). Apologies for being so fierce yesterday.

No problem. I will do this going forward.

GideonBature · 2025-05-15T20:48:59Z

Returns column needs updating (and Notes).

Noted!

GideonBature · 2025-05-15T20:49:19Z

Holy moly you picked a difficult one. I'm going to have to come back to this when I can put more thought into it. Feel free to ignore my suggestions until then.

Noted....

GideonBature · 2025-05-15T21:09:59Z

Returns column needs updating (and Notes).

for the notes, is there any need to change it? since it describes perfectly that the scantxoutset is experimental.

tcharding · 2025-05-16T00:19:53Z

Oh you are right, lets leave the notes as they are.

tcharding · 2025-05-27T05:41:20Z

Man this method is really not that simple to add support for because it changes so often. Can we put this one on hold until you've got a few more easy ones done?

GideonBature · 2025-05-28T22:33:43Z

Man this method is really not that simple to add support for because it changes so often. Can we put this one on hold until you've got a few more easy ones done?

Understood... sure, let's do that.

jamillambert

I made a few comments, they apply to all affected versions.

jamillambert · 2025-07-21T19:14:22Z

client/src/client_sync/v29/mod.rs

 #[rustfmt::skip]                // Keep public re-exports separate.
 pub use crate::client_sync::{
-    v17::{AddNodeCommand, ImportMultiRequest, ImportMultiScriptPubKey, ImportMultiTimestamp, Input, Output, SetBanCommand, WalletCreateFundedPsbtInput,},
+    v17::{AddNodeCommand, ImportMultiRequest, ImportMultiScriptPubKey, ImportMultiTimestamp, Input, Output, SetBanCommand, WalletCreateFundedPsbtInput


nit: This change is unrelated and wrong. It's not fixed by cargo fmt due to the skip above the block.

NB. I'm ok with the random fix being in this PR if done correctly though.

jamillambert · 2025-07-21T19:34:15Z

types/src/v17/blockchain/mod.rs

+
+#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]
+pub struct ScanTxOutSetAbort(pub bool);


Needs rustdocs

jamillambert · 2025-07-21T19:36:01Z

types/src/v17/blockchain/mod.rs

+#[derive(Deserialize, Debug, Clone, PartialEq)]
+pub struct ScanTxOutSetStatus {
+    /// Approximate percent complete
+    pub progress: f64,
+}


Suggested change

#[derive(Deserialize, Debug, Clone, PartialEq)]

pub struct ScanTxOutSetStatus {

/// Approximate percent complete

pub progress: f64,

}

#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]

pub struct ScanTxOutSetStatus(pub f64);

Also needs docs. Was there a reason serialize was not included that I have missed?

jamillambert · 2025-07-21T19:41:05Z

integration_test/tests/blockchain.rs

+
+    let _: Option<ScanTxOutSetStatus> = node.client.scan_tx_out_set_status().expect("scantxoutset status");
+
+    let model: Result<mtype::ScanTxOutSetStart, ScanTxOutSetError> = json.into_model();


Moving this line to directly below let json makes more sense. I had to look twice and first thought the model for ..Status was being checked and not ..Start.

jamillambert · 2025-07-21T19:43:27Z

types/src/model/blockchain.rs

+    pub total_amount: Amount,
+}
+
+#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]


Suggested change

#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]

/// Unspents item returned as part of `scantxoutset`

#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]

Needs docs, e.g. above. Having scanned through the code a lot recently I find it useful if the original RPC is mentioned.

jamillambert · 2025-07-21T21:03:09Z

types/src/v18/blockchain/mod.rs

+}
+
+#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]
+pub struct ScanTxOutSetStart {


I added #[serde(deny_unknown_fields)] to this to test, and there are two missing fields, success and searched_items.

jamillambert · 2025-07-21T21:05:49Z

types/src/v25/blockchain/mod.rs

+/// > Returns an object containing various state info regarding blockchain processing.
+#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]
+#[serde(deny_unknown_fields)]
+pub struct GetBlockchainInfo {


Most of the changes to this file are not part of this PR, left over from a copy and paste from v19?

tcharding · 2025-09-04T03:03:40Z

Setting to draft since this seems to be idle for now.

jamillambert · 2025-09-05T09:10:44Z

I'll pick this up and finish it off if you have no objection @GideonBature?

jamillambert

I had a quick look at this and there have been so many changes to master in the meantime the merge conflicts are going to be a pain. I would suggest dropping all exports/imports from the commit fixing the remaining merge conflicts and then adding them back manually afterwards.

GideonBature · 2025-09-05T09:59:52Z

I had a quick look at this and there have been so many changes to master in the meantime the merge conflicts are going to be a pain. I would suggest dropping all exports/imports from the commit fixing the remaining merge conflicts and then adding them back manually afterwards.

Noted!

GideonBature · 2025-09-05T10:01:49Z

I'll pick this up and finish it off if you have no objection @GideonBature?

No objection, sorry, was a little unstable that's why I left it this long. Will resolve the merge conflicts and other necessary fix.

Thank you!

luisschwab · 2025-12-03T21:47:29Z

@GideonBature are you still working on this one?

GideonBature · 2025-12-04T15:15:44Z

@luisschwab Yes, I am currently resolving the merge conflict...

Split single return type to three types Rename some fields for readability Rename some fields for readability

Format code

jamillambert

There have been a lot of changes since this PR was opened and the merge conflicts might be difficult. Let me know if you want me to take over and get it done.

GideonBature · 2025-12-04T16:04:20Z

@jamillambert I was able to resolve the merge conflict, however, you can pick it up from there, truly there have been a lot of changes since the last time I made any changes.

Thank you.

GideonBature · 2025-12-04T16:05:59Z

Then, scantxoutset needs to be added to support v30 also the two failed checks are due to that.

jamillambert

@GideonBature Thanks for all the work and fixing the merge conflicts.

I'll make the last few remaining changes to get it over the line.

GideonBature · 2025-12-08T19:03:09Z

@GideonBature Thanks for all the work and fixing the merge conflicts.

I'll make the last few remaining changes to get it over the line.

Thank you @jamillambert

jamillambert · 2025-12-15T16:52:07Z

Continued in #428

1e51177 Implement scantxoutset method and test (GideonBature) Pull request description: The method is marked as experimental and was not implemented. Implement the method and all the changes up to v30. Original PR is #164 by GideonBature. Picked up and fixed by jamillambert. ACKs for top commit: tcharding: ACK 1e51177 Tree-SHA512: d77c346ddddc1fb41bd352c8606a63b3f66d50f951dc3f07744973f4c5a491ef572a336a54b9f87c8fb3a3013a3a29cf75c687ea8de632c3eb32270897c7b3f1

GideonBature force-pushed the scantxoutset branch 3 times, most recently from 63e4f61 to 67b03b6 Compare May 12, 2025 23:49

GideonBature force-pushed the scantxoutset branch from 67b03b6 to 43c8b61 Compare May 14, 2025 17:33

tcharding reviewed May 15, 2025

View reviewed changes

integration_test/tests/blockchain.rs Outdated Show resolved Hide resolved

types/src/v17/blockchain/mod.rs Outdated Show resolved Hide resolved

types/src/v17/blockchain/mod.rs Outdated Show resolved Hide resolved

GideonBature force-pushed the scantxoutset branch from 43c8b61 to 9b7f019 Compare May 15, 2025 20:58

GideonBature force-pushed the scantxoutset branch from 9b7f019 to 1a3bd20 Compare May 15, 2025 21:10

GideonBature force-pushed the scantxoutset branch from 1a3bd20 to 901bf21 Compare May 18, 2025 13:34

tcharding marked this pull request as draft May 27, 2025 05:41

GideonBature closed this May 31, 2025

GideonBature deleted the scantxoutset branch May 31, 2025 08:09

GideonBature restored the scantxoutset branch May 31, 2025 08:35

GideonBature reopened this May 31, 2025

github-actions bot added C-client C-integration-test C-types labels May 31, 2025

jamillambert reviewed Jul 21, 2025

View reviewed changes

tcharding marked this pull request as draft September 4, 2025 03:03

jamillambert reviewed Sep 5, 2025

View reviewed changes

tvpeter mentioned this pull request Nov 19, 2025

Add RPC Blockchain methods for Core v28, v29 and v30 bitcoindevkit/bdk-bitcoind-client#4

Closed

luisschwab mentioned this pull request Nov 23, 2025

Add scantxoutset method bitcoindevkit/bdk-bitcoind-client#7

Open

GideonBature added 2 commits December 4, 2025 16:32

Implement scantxoutset method and test

371d4ec

Split single return type to three types Rename some fields for readability Rename some fields for readability

Format code

78fb920

Format code

jamillambert reviewed Dec 4, 2025

View reviewed changes

Resolve merge conflict

3223143

GideonBature force-pushed the scantxoutset branch from 52d9d1c to 3223143 Compare December 4, 2025 15:57

Format code

8d929b1

github-actions bot added the C-verify label Dec 4, 2025

GideonBature added 2 commits December 4, 2025 17:34

Add scantxoutset for bitcoin v30

2a6a483

Update the Returns for the scantxoutset method doc

7c9e3b5

GideonBature marked this pull request as ready for review December 4, 2025 17:31

GideonBature requested a review from jamillambert December 4, 2025 17:31

jamillambert reviewed Dec 8, 2025

View reviewed changes

jamillambert mentioned this pull request Dec 15, 2025

Implement scantxoutset method and test #428

Merged

jamillambert closed this Dec 15, 2025


		#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]
		pub struct ScanTxOutSetAbort(pub bool);


		let _: Option<ScanTxOutSetStatus> = node.client.scan_tx_out_set_status().expect("scantxoutset status");

		let model: Result<mtype::ScanTxOutSetStart, ScanTxOutSetError> = json.into_model();

	#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]
	/// Unspents item returned as part of `scantxoutset`
	#[derive(Clone, Debug, PartialEq, Deserialize, Serialize)]

Conversation

GideonBature commented May 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tcharding commented May 13, 2025

Uh oh!

GideonBature commented May 13, 2025

Uh oh!

tcharding commented May 13, 2025

Uh oh!

GideonBature commented May 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tcharding commented May 15, 2025

Uh oh!

tcharding commented May 15, 2025

Uh oh!

tcharding commented May 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

tcharding left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

GideonBature commented May 15, 2025

Uh oh!

GideonBature commented May 15, 2025

Uh oh!

GideonBature commented May 15, 2025

Uh oh!

GideonBature commented May 15, 2025

Uh oh!

tcharding commented May 16, 2025

Uh oh!

tcharding commented May 27, 2025

Uh oh!

GideonBature commented May 28, 2025

Uh oh!

jamillambert left a comment

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jamillambert Jul 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tcharding commented Sep 4, 2025

Uh oh!

jamillambert commented Sep 5, 2025

Uh oh!

jamillambert left a comment

Choose a reason for hiding this comment

Uh oh!

GideonBature commented Sep 5, 2025

Uh oh!

GideonBature commented Sep 5, 2025

Uh oh!

luisschwab commented Dec 3, 2025

Uh oh!

GideonBature commented May 12, 2025 •

edited

Loading

GideonBature commented May 14, 2025 •

edited

Loading

tcharding commented May 15, 2025 •

edited

Loading

jamillambert Jul 21, 2025 •

edited

Loading

jamillambert Jul 21, 2025 •

edited

Loading

jamillambert Jul 21, 2025 •

edited

Loading

GideonBature commented Dec 4, 2025 •

edited

Loading